Des constantes sont définies pour aider à utiliser les commandes:
L'interface de script fournit deux variables contenant la version
courante de Scribus dans le module Scribus. Les scripts peuvent utiliser ces variables pour vérifier qu'ils tournent sous la bonne version de Scribus et pour informer l'utilisateur d'éventuelles incompatibilités. Ces
deux variables, scribus_version et
scribus_version_info, ont été ajoutées dans les versions
1.2.1 et 1.3.0cvs et sont absentes des versions
précédentes. Si nécessaire, vous pouvez vérifier leur présence avec hasattr(scribus, 'scribus_version').
scribus_version est une chaîne qui contient la version courante de Scribus. Sa valeur ressemble habituellement à '1.2.1cvs' ou '1.3.0', par exemple, mais il n'est pas garanti que le format sera toujours le même. Cette
variable est utile pour afficher la version à l'utilisateur, par exemple pour signaler une incompatibilité. N'analysez pas et ne comparez pas cette variable, car scribus_version_info est fait pour cela.
scribus_version_info est un vecteur semblable au vecteur sys.version_info fourni par Python.
C'est un vecteur de la forme (majorversion, minorversion, patchlevel,
extraversion, build), par exemple 1.2.1cvs correspond à
(1,2,1,'cvs',0) et 1.3.2 correspond à (1,3,2,'',0) . Ces vecteurs sont idéaux pour vérifier les versions minimum, etc., parce que Python compare les vecteurs élément par élément, de gauche à droite. Par exemple :
if scribus.scribus_version_info[:3] < (1,2,2):
messageBox("Scribus - script Python",
"Ce script requiert 1.2.2 ou plus récent."+\
"Vous roulez %s." % scribus.scribus_version,
ICON_CRITICAL)
sys.exit()
Constantes d'énumération d'unités :
- UNIT_POINTS
- Unité de mesure point = 0
- UNIT_MILLIMETERS
- Unité de mesure millimètre = 1
- UNIT_INCHES
- Unité de mesure pouce = 2
- UNIT_PICAS
- Unité de mesure pica = 3
Constantes de conversion d'unités
Ces facteurs de conversion peuvent être utilisés pour convertir les unités en points et vice versa.
Ainsi, pour convertir les pouces en points, il suffit d'écrire 'valeur/inch'; pour convertir les points en pouces vous écrirez 'valeur*inch', et pour convertir les pouces en mm vous écrirez 'valeur*mm/inch'.
- pt
- points dans 1 pt
- inch
- pouces dans 1 pt
- p
- pica dans 1 pt
- cm
-
- centimètres dans 1 pt
- mm
- millimètres dans 1 pt
- ...
- D'autres constantes seront fournies si le coeur de Scribus les reconnaît.
Définitions d'orientation de page :
- PORTRAIT
- Pageformat Portrait = 0
- LANDSCAPE
- Pageformat Landscape = 1
Réglages de format de page :
- PAPER_A0
- Paperformat A0 = 2380 x 3368 Points
- PAPER_A1
- Paperformat A1 = 1684 x 2380 Points
- PAPER_A2
- Paperformat A2 = 1190 x 1684 Points
- PAPER_A3
- Paperformat A3 = 842 x 1190 Points
- PAPER_A4
- Paperformat A4 = 595 x 842 Points
- PAPER_A5
- Paperformat A5 = 421 x 595 Points
- PAPER_A6
- Paperformat A6 = 297 x 421 Points
- PAPER_A7
- Paperformat A7 = 210 x 297 Points
- PAPER_A8
- Paperformat A8 = 148 x 210 Points
- PAPER_A9
- Paperformat A9 = 105 x 148 Points
- PAPER_B0
- Paperformat B0 = 2836 x 4008 Points
- PAPER_B1
- Paperformat B1 = 2004 x 2836 Points
- PAPER_B2
- Paperformat B2 = 1418 x 2004 Points
- PAPER_B3
- Paperformat B3 = 1002 x 1418 Points
- PAPER_B4
- Paperformat B4 = 709 x 1002 Points
- PAPER_B5
- Paperformat B5 = 501 x 709 Points
- PAPER_B6
- Paperformat B6 = 355 x 501 Points
- PAPER_B7
- Paperformat B7 = 250 x 355 Points
- PAPER_B8
- Paperformat B8 = 178 x 250 Points
- PAPER_B9
- Paperformat B9 = 125 x 178 Points
- PAPER_B10
- Paperformat B10 = 89 x 125 Points
- PAPER_C5E
- Paperformat C5E = 462 x 649 Points
- PAPER_COMM10E
- Paperformat Comm10E = 298 x 683 Points
- PAPER_DLE
- Paperformat DLE = 312 x 624 Points
- PAPER_EXECUTIVE
- Paperformat Executive = 542 x 720 Points
- PAPER_FOLIO
- Paperformat Folio = 595 x 935 Points
- PAPER_LEDGER
- Paperformat Ledger = 1224 x 792 Points
- PAPER_LEGAL
- Paperformat Legal = 612 x 1008 Points
- PAPER_LETTER
- Paperformat Letter = 612 x 792 Points
- PAPER_TABLOID
- Paperformat Tabloid = 792 x 1224 Points
Réglages de la disposition du document :
- FACINGPAGES
- Disposition avec des pages en regard.
- NOFACINGPAGES
- Disposition normale du document.
- FIRSTPAGELEFT
- La première page du document est une page de droite.
- FIRSTPAGERIGHT
- La première page du document est une première de droite.
Réglages d'alignement
- ALIGN_LEFTK
- Le texte est aligné à gauche.
- ALIGN_CENTERED
- Le texte est centré dans le cadre de texte.
- ALIGN_RIGHT
- Le texte est aligné sur le côté droit du cadre de texte.
- ALIGN_FORCED
- Le texte a un alignement forcé.
- ALIGN_BLOCK
- Le texte a un alignement bloqué.
Réglages relatifs aux lignes :
- LINE_DASH
- LINE_DASHDOT
- LINE_DASHDOTDOT
- LINE_DOT
- LINE_SOLID
- JOIN_BEVEL
- JOIN_MITTER
- JOIN_ROUND
- CAP_FLAT
- CAP_ROUND
- CAP_SQUARE
Réglages relatifs au fond :
- FILL_NOG
- Pas de dégradé, couleur unie
- FILL_HORIZONTALG
- FILL_VERTICALG
- FILL_DIAGONALG
- FILL_CROSSDIAGONALG
- FILL_RADIALG
Boutons de dialogue
- BUTTON_ABORT
- BUTTON_CANCEL
- BUTTON_IGNORE
- BUTTON_NO
- BUTTON_NONE
- BUTTON_OK
- BUTTON_RETRY
- BUTTON_YES
Icônes de dialogue
- ICON_CRITICAL
- ICON_INFORMATION
- ICON_NONE
- ICON_WARNING